home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / gen / fwheel / fwheel.doc < prev    next >
Encoding:
Text File  |  1993-11-28  |  8.6 KB  |  173 lines
  1. ┌────────────────────────────────────────────────────────────────────┐
  2. │▒▒▒ FWHEEL v1.0  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  3. └────────────────────────────────────────────────────────────────────┘
  4.  Author    : Truman Brown
  5.  Copyright : 1993, All Rights Reserved Worldwide
  6.  
  7.  This program is shareware ($5.00 US).  You are welcome to copy this
  8.  software and distribute it to other users as long as the contents
  9.  of the original archive file remain unaltered.
  10.  
  11. ┌────────────────────────────────────────────────────────────────────┐
  12. │▒▒▒ Introduction ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  13. └────────────────────────────────────────────────────────────────────┘
  14.  Welcome to FWHEEL ... a little program I cooked up one night.
  15.  
  16.  FWHEEL is a data file generator for the Persistance of Vision
  17.  (POVRAY) raytracer and the Vivid raytracer.  FWHEEL is based on a
  18.  simple concept of repeating polygons subjected to similar
  19.  transformations.  Basically, an n-sided polygon is created m-number
  20.  of times; each instance is rotated and reduced in such a way that the
  21.  vertices of the new polygon lie on the sides of the previous one.
  22.  Though not 100% (self)similar, this concept is somewhat like a
  23.  fractal - therefore the name "FWHEEL".
  24.  
  25.  FWHEEL is designed for the individual who is somewhat familiar with
  26.  raytracing and wants to create a quick and easy animation that is
  27.  both attractive and unique.
  28.  
  29. ┌────────────────────────────────────────────────────────────────────┐
  30. │▒▒▒ System Requirements ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  31. └────────────────────────────────────────────────────────────────────┘
  32.  - An IBM (8086) or compatible CPU.
  33.  - A VGA graphics adapter or better
  34.  - A Microsoft-compatible mouse
  35.  
  36. ┌────────────────────────────────────────────────────────────────────┐
  37. │▒▒▒ Running FWHEEL ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  38. └────────────────────────────────────────────────────────────────────┘
  39.  Make sure your mouse driver is loaded.
  40.  Type FWHEEL.
  41.  Press Enter.
  42.  
  43. ┌────────────────────────────────────────────────────────────────────┐
  44. │▒▒▒ Menu Options ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  45. └────────────────────────────────────────────────────────────────────┘
  46.  FWHEEL's menu options allow you to either change program parameters
  47.  or to create data files.  You select a menu option by moving your
  48.  mouse cursor over the appropriate button and clicking the left mouse
  49.  button.  You may also use your keyboard cursor keys to move the screen
  50.  cursor to a desired option.  Pressing ENTER will select the option.
  51.  
  52.  The following is an explanation of the various options:
  53.  
  54.     Sides           [range 3 - 999]
  55.        This specifies the number of sides of the polygon shape.
  56.        Note that selecting Sides greater than 10 tends to create
  57.        polygons very similar to circles - which typically aren't
  58.        very interesting to look at.
  59.     Levels          [range 1 - 999]
  60.        This specifies the number of times the polygon is repeated with-
  61.        in itself.  Note that while FWHEEL's wireframe preview is very
  62.        fast, large Levels values can tend to slow down its wireframe
  63.        previews considerably.
  64.     Layers          [range 1 - 999]
  65.        This specifies the number of stacked copies of polygon sets to
  66.        create.  Depth of the copies is controlled by an editable
  67.        variable called DPT in the data files.  Similar to Levels, large
  68.        Layers values will slow down previews (and make your data files
  69.        BIG!).
  70.     Frames          [range 1 - 999]
  71.        This specifies the number of animation frames to create.  Each
  72.        frame represents a separate data file, so be sure you have the
  73.        appropriate amount of disk space available to store the number
  74.        of frames you select.
  75.        Low values tend to create short, jerky animations while high
  76.        values tend to create large, smoother animations.  Since FWHEEL
  77.        creates a looping animation, it is recommended that you select
  78.        values that align easily with a 360 degree range (i.e., 30, 60,
  79.        120, 180, or 360 frames).
  80.     SphereRadius    [any positive real number less 999999.00]
  81.        This specifies the radius of the spheres at the corners of the
  82.        polygons.
  83.     ConeRadius      [any positive real number less 999999.00]
  84.        This specifies the radius of the cones used to create the poly-
  85.        gons.
  86.     OuterColor
  87.        This specifies the color desired for the primary (largest/outer)
  88.        polygon.  Clicking on OuterColor brings up a submenu with pre-
  89.        defined color values.  Click on PGUP or PGDN to find an appro-
  90.        priate color.  These pre-defined colors are the same as those
  91.        specified in the POVRAY include-file "COLORS.INC".
  92.        Colors selected for Outer, Middle, and Inner colors are
  93.        interpolated throughout the polygons.
  94.     MiddleColor
  95.        Same as OuterColor except that this specifies the value of the
  96.        color of the mid-most polygon.
  97.     InnerColor
  98.        Same as OuterColor and MiddleColor except that this specifies
  99.        the color of the inner-most polygon.
  100.     Rotation
  101.        This specifies an optional rotation that can be applied to your
  102.        animation.  The default value is None.  When selected, a sub-
  103.        menu appears where you can choose a rotation of None, X-Axis,
  104.        Y-Axis, or Z-Axis.  Hint: a Z-axis rotation will create a very
  105.        eye-catching effect.
  106.     Output
  107.        This specifies which raytracer you desire to write to.
  108.        When selected a sub-menu appears where you may choose either
  109.        POV or Vivid.
  110.        Vivid users should note that the data generated will correctly
  111.        reflect Vivid's right-handed XYZ orientations.
  112.     Filename
  113.        This specifies the four-letter basename for the animation files
  114.        output by FWHEEL.  Files are generated sequentially as in --
  115.        FILE0001.POV, FILE0002.POV, ... FILE####.POV and FILE.INC.  For
  116.        Vivid output you will find FILE0001.V, FILE0002.V, ...
  117.        FILE####.V and FILE.VO.
  118.        The .INC and .VO files contain the camera/studio setup, color
  119.        values, textures, etc., for your animation.
  120.     Run
  121.        Selecting Run will cause a submenu to appear.  Options availa-
  122.        ble under the submenu are TEST and MAKE.  Both options activate
  123.        a wireframe display of the current animation.  Selecting TEST
  124.        allows you to preview the animation without generating any files.
  125.        MAKE will create the raytracing files.
  126.     About
  127.        This button displays the program credits.
  128.     Quit
  129.        This button enables you to exit the program.
  130.  
  131.  Once you've generated the raytracing files, it is simply a matter of
  132.  rendering each file using the appropriate raytracer, then compiling
  133.  the animation with a suitable utility (such as Dave's Targa Animator
  134.  [DTA]), and enjoying your FWHEEL animation!
  135.  
  136. ┌────────────────────────────────────────────────────────────────────┐
  137. │▒▒▒ Legal Disclaimer ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  138. └────────────────────────────────────────────────────────────────────┘
  139.  The author, Truman Brown, provides the accompanying software and
  140.  nonexclusively licenses its use on the following terms and condi-
  141.  tions.
  142.  
  143.  The software (FWHEEL version 1.0) is copyrighted by Truman Brown
  144.  with all rights reserved worldwide.
  145.  
  146.  You assume FULL RESPONSIBILITY for the selection of the software to
  147.  achieve your intended purposes, and for its proper installation and
  148.  use.  The author DOES NOT warrant that the software will meet your
  149.  requirements, that the software is fit for any particular purpose or
  150.  that the use of the software will be error-free.
  151.  
  152.  All warranties, whether oral, written, expressed, or impled, includ-
  153.  ing without limitation warranties of merchantability or fitness for
  154.  a particular purpose are EXPRESSLY DISCLAIMED.  In no event will
  155.  the author, Truman Brown, be liable to you, or other users for any
  156.  indirect, incidental, consequential, special or exemplary damages
  157.  arising out of or in connection with the use or inability to use the
  158.  software.
  159.  
  160. ┌────────────────────────────────────────────────────────────────────┐
  161. │▒▒▒ Registration ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  162. └────────────────────────────────────────────────────────────────────┘
  163.  If you find FWHEEL useful, and I hope that you do, please consider
  164.  registering for the amount of $5.00.  Please make checks payable to
  165.  
  166.     Truman Brown
  167.     575 East Howard Street
  168.     Pasadena, California 91104
  169.  
  170.  If you have any questions, suggestions, or requests I can be reached
  171.  electronically on CompuServe (71477,221), or The Graphics Alternatives
  172.  BBS (510-524-2780).
  173.